home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / dev / moni / HunkFunc.readme < prev    next >
Text File  |  2001-07-04  |  5KB  |  123 lines
  1. Short:    V1.14 display executable file structure
  2. Author:   stoecker@epost.de (Dirk Stoecker)
  3. Uploader: stoecker@epost.de (Dirk Stoecker)
  4. Version:  1.14
  5. Type:     dev/moni
  6.  
  7. This program allows you to display information about the structure of an
  8. Amiga executable file (or a link object). HunkFunc requires OS2.0 for work.
  9.  
  10. The first version of this program is made with help of HunkFunk utility
  11. made by Olaf Barthel. But as Olaf's utility misses a lot of hunks and
  12. other information, I made my own tool. This version knows a lot more
  13. possible configurations and is shorter, as it uses Amiga functions instead
  14. of ANSI-C.
  15.  
  16. Know hunk types are: HUNK_UNIT, HUNK_NAME, HUNK_CODE, HUNK_DATA, HUNK_BSS,
  17. HUNK_(ABS)RELOC32, HUNK_(REL)RELOC16, HUNK_(REL)RELOC8, HUNK_EXT, HUNK_SYMBOL,
  18. HUNK_DEBUG, HUNK_END, HUNK_HEADER, HUNK_OVERLAY, HUNK_BREAK,
  19. HUNK_DREL32, HUNK_DREL16, HUNK_DREL8, HUNK_LIB, HUNK_INDEX,
  20. HUNK_RELOC32SHORT, HUNK_RELRELOC32, HUNK_ABSRELOC16, HUNK_PPC_CODE,
  21. HUNK_RELRELOC26.
  22.  
  23. The File has following argument line:
  24. "FILE/M/A,SREL=SHOWRELOC/S,SSYM=SHOWSYMBOL/S,SEXT=SHOWEXTERN/S,
  25.  SEREF=SHOWEXTERNREF/S,SOVT=SHOWOVERLAYTABLE/S,STATS/S".
  26.  
  27. FILE       You must pass at least one file name, but may pass a lot more.
  28.            Patterns are not supported.
  29. SHOWRELOC  displays all reloc entries (there may be really much of them!)
  30. SHOWSYMBOL displays symbol names of HUNK_SYMBOL
  31. SHOWEXTERN displays definitions of HUNK_EXT
  32. SHOWEX-REF displays references of HUNK_EXT
  33. SHOWOVERL. display data of overlay table
  34. STATS      show short statistics about file
  35.  
  36. Example output:
  37. File 'C:AddDataTypes':
  38. HUNK_HEADER
  39.   Numhunks =         2 (0 to 1)
  40.   Hunk 000 =      5560 ($0015B8) Bytes
  41.   Hunk 001 =       160 ($0000A0) Bytes
  42.  
  43. HUNK_CODE         5560 ($0015B8) Bytes
  44. HUNK_RELOC32
  45.   Summary            5 entries to hunk 1
  46. HUNK_END
  47.  
  48. HUNK_DATA          160 ($0000A0) Bytes
  49. HUNK_RELOC32
  50.   Summary           14 entries to hunk 0
  51. HUNK_END
  52.  
  53. - First line shows program name.
  54. - HUNK_HEADER is the first hunk of an executable and lists all the hunks.
  55.   There may be additionally comments like CHIP, FAST, ADVISORY or MEMTYPE.
  56. - HUNK_CODE and HUNK_DATA store information.
  57. - HUNK_BSS store memory space, which is filled with 0 on startup.
  58. - HUNK_RELOC32 (and other types) hold relocation information.
  59. - HUNK_END ends an hunk entry.
  60. - In HUNK_CODE, HUNK_DATA and HUNK_BSS the memory flags may be repeated
  61.   in first or second longword. The flags is displayed normally when in
  62.   second longword (size) and preceeded by a '_' (e.g. _CHIP), when in
  63.   first longword (hunk type).
  64. - HUNK_DREL32EXE is in real a HUNK_RELOC32SHORT which uses wrong ID due
  65.   to a bug in OS V37.
  66.  
  67. A lot more information about executable or object file format can be found
  68. in:
  69.  
  70.                 The Amiga Guru Book
  71.                 ©1989,1993 by Ralph Babel
  72.                 Taunusstein 1993
  73.  
  74. If HunkFunc prints a line like "HUNK_??? ($xxxx) - Aborting!", please
  75. contact me and send an example file (if the file is a correct one).
  76.  
  77. Use this tool as you want, but WITHOUT ANY WARRANTY!
  78.  
  79. Contact me at:
  80.  
  81. *********************************************************************
  82. * snail-mail:                  * e-mail:                            *
  83. *   Dirk Stoecker              *   stoecker@epost.de                *
  84. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  85. *   01877 Bischofswerda        * world wide web:                    *
  86. *   GERMANY                    *   http://www.dstoecker.de/         *
  87. * phone:                       * pgp key:                           *
  88. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  89. *********************************************************************
  90.  
  91. Following is my PGP signature for the corresponding LhA-File.
  92. Use ' pgpv HunkFunc.readme -o HunkFunc.lha ' to check it.
  93. Key fingerprint: B9 F2 3A 1A 29 02 75 16  6A C6 5B 7D 5E F6 16 CF.
  94. All my releases after April 2001 have a PGP signature with this key.
  95. Be alarmed if signature is missing or wrong.
  96.  
  97. -----BEGIN PGP SIGNATURE-----
  98. Version: PGPfreeware 5.0i for non-commercial use
  99. MessageID: qVIx+1u4qWmwAC5W9lxdPkNhMi2P6EjF
  100.  
  101. iQCVAwUAOzRwr7OTsAT/iOY9AQFbRAP9EQS6t8ZwUio33mdcujxZEbu6L+9+tEQV
  102. /cMq95jTdwRQjnvMF+509K04mRoSCG7ClzsJmsAB0VM/CtULm7loqlmLjW4LOuej
  103. SgRRRaNmDqn7El8UglXYXYXGkZZsfGPKkkwP6p19/IyB2mSib6nzukhoSdz4r4OQ
  104. XBcJSpgOy18=
  105. =6zGt
  106. -----END PGP SIGNATURE-----
  107.  
  108.  
  109. ============================= Archive contents =============================
  110.  
  111. Original  Packed Ratio    Date     Time    Name
  112. -------- ------- ----- --------- --------  -------------
  113.     2146    1519 29.2% 23-Jun-01 12:33:34  HunkFunc.info
  114.     8288    3762 54.6% 23-Jun-01 12:33:34 +HunkFunc
  115.     3674    1640 55.3% 23-Jun-01 12:33:34 +HunkFunc.readme
  116.    17076    4868 71.4% 23-Jun-01 12:33:34 +HunkFunc.c
  117.     2188     805 63.2% 23-Jun-01 12:33:34 +SDI_ASM_STD_functions.lib
  118.     5603    1970 64.8% 23-Jun-01 12:33:34 +SDI_ASM_STD_protos.h
  119.     1257     550 56.2% 23-Jun-01 12:33:34 +SDI_version.h
  120.      411     260 36.7% 23-Jun-01 12:33:34 +SMakeFile
  121. -------- ------- ----- --------- --------
  122.    40643   15374 62.1% 26-Jun-101 01:43:50   8 files
  123.